SCSL 에러코드
1. 에러코드 구분
| 구분 | 값 |
|---|---|
| 성공 | 0 |
| 일반 오류 | -1 |
| 서버 설정 및 동작 관련 오류 | -1000~ |
| 서버 통신 관련 오류 | -2000~ |
| 키 파일 오퍼레이션 관련 경고/오류 | -3000~ |
| 키 파일 관련 정보 경고 | -4000~ |
| 키 파일 개수 오류 | -5000~ |
| UID 오류 | -6000~ |
| 키 파일 Verify 오류 | -7000~ |
| File 관련 오류 | 1000 ~ |
| Parameter 관련 오류 | 2000 ~ |
| KeyFile 관련 오류 | 3000 ~ |
| Algorithm 관련 오류 | 4000 ~ |
| Property 관련 오류 | 5000 ~ |
| Policy 관련 오류 | 6000 ~ |
2. 에러코드 상세
- 1~
- 1000~
- 2000~
- 3000~
- 4000~
- 5000~
- 6000~
- 7000~
| 값 | 코드선언 | 설명 | 적용모듈 | 해결방법 |
|---|---|---|---|---|
| 1 | RETVAL_FAIL | 키 정보 오류일 경우 | JAVA,DLL | |
| -1 | ERROR_FAIL_CODE | 파라미터가 NULL 일 경우 | DLL | 사용 하지 않음 |
| -11 | ERROR_MEM_ALOCATE | 메모리 할당 에러 | DLL | 사용 하지 않음 |
| -12 | ERROR_MEM_ACCESS | 메모리 접근 에러 | JAVA, DLL | |
| -21 | ERROR_SECU_ALG | 암호화 알고리즘 에러 | DLL | |
| -22 | ERROR_SECU_KEY | 암호화 키에 관련된 에러 | 사용 하지 않음 | |
| -26 | ERROR_GET_ACL | ACL을 얻어오지 못하는 에러 | 사용 하지 않음 | |
| -27 | ERROR_RIGHT_ACL | 올바른 ACL 이 아닐 때 에러 | 사용 하지 않음 | |
| -31 | ERROR_FILE_EXIST | 원본 파일이 존재 하지 않음 | JAVA, DLL | |
| -32 | ERROR_FILE_CREATE | 파일 생성 에러 | DLL | |
| -33 | ERROR_FILE_ACCESS | 파일 접근 에러 | JAVA, DLL | |
| -36 | ERROR_FILE_NOTENCRYPTED | 원본 파일이 암호화 파일이 아님 | JAVA, DLL | |
| -41 | ERROR_FILE_DAMAGED | 사용 하지 않음 | ||
| -51 | NO_SCDSFILE_ACCESS | 사용 하지 않음 | ||
| -61 | ERROR_EXCEPTION | EXCEPTION 에러 | JAVA | |
| -62 | ERROR_FILESIZE_ZERO | 원본 파일 사이즈가 0 | 사용 하지 않음 | |
| -71 | ERROR_EXT_IMPOSSIBLE | 지원하지 않는 확장자 | JAVA, DLL | |
| -72 | ERROR_USER_NOT_FOUND | 입력 받은 유저 ID를 키파일에서 찾을 수 없을 경우 | JAVA, DLL | |
| -73 | ERROR_LOG_FAIL | 로그 생성 실패 | 사용 하지 않음 | |
| -75 | ERROR_INDEXINFO | Index 검색 중 관련 에러 | JAVA | 등급 암호화에서 사용 |
| -76 | ERROR_NOT_DEFINE_INDEXINFO | 정의되지 않는 Index 사용 | JAVA | 등급 암호화에서 사용 |
| -81 | RETVAL_BYPASS | BYPASS 모드인 경우 | JAVA | |
| -91 | ERROR_STREAM_SIZE_ZERO | 사용하지 않음 | ||
| -92 | STREAM_NOTENCRYPTED | 사용하지 않음 |
| 값 | 코드선언 | 설명 | 적용모듈 | 해결방법 |
|---|---|---|---|---|
| 1000 | NO_SOURCE_FILE_EXISTS | 원본 파일이 없음 | JAVA | |
| 1001 | SOURCE_FILESIZE_ZERO | 원본 파일의 크기가 0 | JAVA | |
| 1002 | UNKNOWN_TYPE_OF_FILE | 암호화 파일의 방식을 알 수 없음 | JAVA, DLL | |
| 1003 | ENCFILE_SIZE_FAIL | 암호화 파일 크기 오류 | JAVA, DLL | 사용하지 않음 |
| 1004 | ENCFILE_IS_NOT_DAC | 암호화 파일이 DAC이 아님 | JAVA, DLL | |
| 1005 | ENCFIEL_IS_NOT_MAC | 암호화 파일이 MAC이 아님 | JAVA, DLL | |
| 1006 | ENCFILE_IS_NOT_GRADE | 암호화 파일이 GRADE가 아님 | JAVA, DLL | |
| 1010 | ERROR_ENCFILE_HASH_VALUE | 암호화 파일 헤더의 Hash Value 다름 | JAVA, DLL | |
| 1020 | NO_MATCH_HEADER_KEY | 헤더 복호화 실패 | JAVA, DLL | |
| 1030 | NOT_CREATE_DESTINATION_FILE | 암호화 or 복호화 파일 생성 실패 | JAVA |
| 값 | 코드선언 | 설명 | 적용모듈 | 해결방법 |
|---|---|---|---|---|
| 2000 | NULL_PARAMETER | 파라미터가 NULL | JAVA | |
| 2001 | INVALID_PARAMETER | 파라미터가 유효하지 않음 | JAVA, DLL | |
| 2002 | SAME_FILEPATH | 원본 파일과 대상 파일의 경로가 같음 | JAVA, DLL | |
| 2010 | INVALID_AUTHINFO | 권한 정보 오류 | JAVA, DLL | Client에서 넘겨진 권한 정보가 암호화 파일의 권한 정보와 다름 |
| 값 | 코드선언 | 설명 | 적용모듈 | 해결방법 |
|---|---|---|---|---|
| 3000 | NO_KEYFILE_EXISTS | 키 파일이 없음 | JAVA, DLL | 시스템 소스(설정)에서 Keyfile 선언한 위치 확인 |
| 3001 | NO_SEARCH_IDs_KEY | 키 파일에 사용자 ID가 없음 | JAVA, DLL | 1. 신규사용자가 생성한 문서이지만 키파일이 갱신이 안된경우 2. 암/복호화시 선언한 ID가 Keyfile에 없는 경우 |
| 3002 | MAKE_DOCUMENT_KEY_FAIL | 문서 암호화 키 생성 실패 | JAVA, DLL | |
| 3003 | NOT_FOUND_KEYFILE | 서버 ID에 해당하는 키 파일을 찾을 수 없음 | JAVA, DLL | 타사 또는 다른 서버에서 생선한 문서인지 확인 |
| 3010 | DIFFERENT_TYPE_OF_KEYFILE | 키 파일의 타입이 다름 | JAVA, DLL | |
| 3011 | KEYFILE_IS_NOT_DAC | 키 파일이 DAC 이 아님 | JAVA | |
| 3012 | KEYFILE_IS_NOT_MAC | 키 파일이 MAC 이 아님 | JAVA | |
| 3013 | KEYFILE_IS_NOT_GRADE | 키 파일이 GRADE 가 아님 | JAVA | |
| 3014 | UNKNOWN_TYPE_OF_KEYFILE | 키 파일의 타입을 알 수 없음 | JAVA, DLL | |
| 3020 | KEYFILE_PARSING_FAIL | 키 파일 파싱 실패 | JAVA, DLL | |
| 3021 | KEYFILE_HEADER_INFO_FAIL | 키 파일의 헤더 정보가 틀림 | JAVA, DLL | |
| 3022 | KEYFILE_SIZE_FAIL | 키 파일의 크기 오류 | JAVA, DLL | |
| 3030 | NOT_AUTHENTICATION_KEYFILE | 인증되지 않은 키 파일 | JAVA, DLL | 1. 선언한 서비스ID가 인증이 안된경우 2. 시스템시간이 문서보안서버와 2시간이상 차이나는경우 3. hostname또는 IP가 변경된 경우 |
| 3031 | NOT_SUPPORT_KEYFILE_V3 | 버전 2 또는 3 키 파일 지원하지 않음 | JAVA, DLL | |
| 3032 | INVALID_SERVICE_ID | 서비스 ID가 다름 | JAVA | 3030에서 상세코드로 분리 표시 설명대로 확인 |
| 3033 | INVALID_KEYFILE_TIME | 키파일 사용 유효기간이 경과됨 | JAVA | 3030에서 상세코드로 분리 표시 설명대로 확인 |
| 3034 | INVALID_SYSTEM_TIME | 시스템 시간이 키파일 생성시간과 다름 | JAVA | 3030에서 상세코드로 분리 표시 설명대로 확인 |
| 3040 | KEYFILE_DECRYPT_FAIL | 키 파일 복호화 실패 | JAVA | 3030에서 상세코드로 분리 표시 설명대로 확인 |
| 3050 | NOT_SUPPORT_ALGORITHM | 키 파일이 알고리즘에 사용되는 키 정보를 가지고 있지 않음 | JAVA, DLL | 3030에서 상세코드로 분리 표시 설명대로 확인 |
| 값 | 코드선언 | 설명 | 적용모듈 | 해결방법 |
|---|---|---|---|---|
| 4001 | DECRYPT_FAIL | 복호화 실패 | JAVA | |
| 4010 | NO_SUCH_ALGORITHM | 암호화 알고리즘을 찾을 수 없음 | JAVA, DLL | |
| 4020 | INVALID_KEY | 지정된 키로 초기화를 할 수 없음 | JAVA, DLL | DS_CUSTOM_HEADER_KEY, DS_KEY_ENCRYPTION_KEY 정책을 SECURITYDOMAIN(최상위) 그룹에 적용 후 키매니저 재시작 |
| 4030 | INVALID_ARGUMENT | 부 적절한 인자 | JAVA, DLL | |
| 4040 | ERROR_ALGORITHM | 블록/패딩 암호화/복호화 오류 | JAVA, DLL |
| 값 | 코드선언 | 설명 | 적용모듈 | 해결방법 |
|---|---|---|---|---|
| 5010 | NOT_SECURE_PROPERTY_FILE | 보안 설정 파일이 아님 | JAVA, DLL | 보안 설정 파일 강제 적용 시 |
| 5020 | PROPERTY_FILE_DECRYPT_FAIL | 보안 설정 파일 복호화 실패 | JAVA, DLL |
| 값 | 코드선언 | 설명 | 적용모듈 | 해결방법 |
|---|---|---|---|---|
| 6000 | EXCEPT_DECRYPT_ID | 복호화 불가 문서 ID | JAVA, DLL | 복호화 정책으로 적용 시 |
| 6001 | NOT_ALLOW_READ_AUTH | 복호화 불가 읽기 권한 | JAVA, DLL | 복호화 정책으로 적용 시 |
| 6003 | NOT_ALLOW_EDIT_AUTH | 복호화 불가 편집 권한 | JAVA, DLL | 복호화 정책으로 적용 시 |
| 6010 | NOT_ALLOW_SERVER_ID | 복호화 불가 Server ID | DLL | 설정 파일에 Server ID 목록 설정 시 |
| 값 | 코드선언 | 설명 | 적용모듈 | 해결방법 |
|---|---|---|---|---|
| 7001 | SOCKET_CONNECTION_FAIL | KMS 소켓 연결 상태 실채 | JAVA | |
| 7002 | SOCKET_BUFFER_OVER_FLOW | Buffer over flow | JAVA | |
| 7003 | SOCKET_POOL_INIT_FAIL | Socket Pool 초기화 실패 | JAVA | |
| 7004 | DATA_NULL | 통신 데이터 값이 null | JAVA | |
| 7005 | DATA_PARSING_FAIL | 통신 데이터의 Object가 파싱 실패 | JAVA | |
| 7006 | NOT_EXIST_KEY_FILE | 존재하지 않는 키 파일 요청시 | JAVA | / 실제 표시 에러코는 3000 |
| 7007 | UNUSUAL_CONNECTION | Prifix 값이 없는 알 수 없는 통신으로 인한 실패 | JAVA |